home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / misc / edu / Calgor.lha / Cal / Docs / Readme < prev    next >
Encoding:
Text File  |  1996-03-23  |  5.1 KB  |  150 lines
  1. Readme - Calgor V1.21 - 23/3/96
  2.  
  3. Introduction
  4.  
  5. Calgor started life as third year University project (under the
  6. heading of Demonstrations of Computer Science).  The primary goal
  7. being to create an environment where the user could learn about
  8. different algorithms and their design.  It is based on two
  9. different learning strategies, that of drill and rote and
  10. learning through personal experimentation.
  11.  
  12. You may use Calgor as is, The player comes with the following
  13. installed:-
  14.  
  15. Demonstrations of While, Do While, For, If and Switch C program
  16. control statements. Array data structure example, Insertion,
  17. Selection, Bubble and Quick Sort Algorithms (all with .txt files
  18. explaining their mechanics).
  19.  
  20. Or if you have a C compiler you can use it to animate your own C
  21. algorithms (See the Calgor Programming Manual for details).
  22.  
  23. Requirements
  24.  
  25. Calgor needs 1 MB chip ram, 1/2 MB Other Ram, Workbench 2.04+ and
  26. one out of the following fonts installed: helvetica 13,  times
  27. 11, courier 11 or napsa 11.  Calgor is run from Workbench,
  28.  
  29. Running From Disk
  30.  
  31. Double click on the Calgor Icon and the program will run.  You
  32. may have to alter data/editor.dat to point at your favourite text
  33. viewer, default is set to "ed" (To do this just edit
  34. data/editor.dat with a text editor).  If you are going to program
  35. your own C algorithms, you will need to copy the hold directory
  36. to your compilers header search path (The default directory used
  37. by Dice is Dinclude:).
  38.  
  39. Installing Disk To Hard Drive
  40.  
  41. Just copy the Disk "Cal" to the destination directory you
  42. want (by dragging the Disk Icon Cal over to the directory).
  43.  
  44. Place in the s:user-startup an Assign, which assigns The Volume
  45. Cal: to the directory path leading to Calgor directory.
  46.  
  47. E.g.
  48.  
  49. I have copied Cal over to "Work:programming/" so the assign
  50. would be
  51.  
  52. "Assign Cal: Work:programming/Cal"
  53.  
  54. Reboot, then just double click on the Calgor Icon to run.
  55. Double click on the Calgor Icon and the program will run.  You
  56. may have to alter Cal:data/editor.dat to point at your favourite
  57. text viewer, default is set to "ed" (To do this just edit
  58. data/editor.dat with a text editor).
  59.  
  60. If you are going to program your own C algorithms, you will need
  61. to copy the hold directory to your compilers header search path
  62. (the default directory used by Dice is Dinclude:).
  63.  
  64. Instructions For Use: Program, Menu
  65.  
  66. Use the Function keys (F1-F5) to select the heading and the
  67. number keys (1-5) to select the options.  Alternatively you can
  68. use the mouse and left click on either the function key graphic
  69. to select the heading, or the key graphic to select the option.
  70. Clicking on the exit box or pressing ESC will exit from the
  71. program.
  72.  
  73. You may at any time press Left Amiga and M to flick through the
  74. different screens and hence get back to the workbench (This will
  75. have the affect of putting Calgor to sleep).  To restore
  76. Calgor, go to the Workbench Menus and select the Tools
  77. "Restore_Calgor" Option.
  78.  
  79. Keys: Menu:
  80.  
  81. F1:  Heading-Option Bank 1      Num Key 1       Option 1
  82. F2:  Heading-Option Bank 2      Num Key 2       Option 2
  83. F3:  Heading-Option Bank 3      Num Key 3       Option 3
  84. F4:  Heading-Option Bank 4      Num Key 4       Option 4
  85. F5:  Heading-Option Bank 5      Num Key 5       Option 5
  86.  
  87. Left Amiga and M - Put Calgor to sleep.
  88.  
  89. To play an animation
  90.  
  91. The animation menu has six functions, Play, Fast Forward, Pause,
  92. Stop, Eject and Information, to initiate a function just click on
  93. their respective graphics or press the appropriate keys (see
  94. below).
  95.  
  96. Keys, Animation Menu
  97.  
  98. Num Key 1 - Play
  99. Num Key 2 - Fast Forward (Accumulative)
  100. Num Key 3 - Pause
  101. Num Key 4 - Stop
  102. Num Key 5 - Information
  103. ESC       - Eject or Stop (Depends on if an animation is playing
  104.             or not).
  105.  
  106. The information function may only be accessed when the animation
  107. is paused or stopped and will cause the .txt file for that
  108. demonstration to be displayed via the text editor named in
  109. data/editor.dat.
  110.  
  111. Specification
  112.  
  113. This version of Calgor (V1.21) is limited in what it can do.
  114. Since I'm starting a whole new project, anyone wishing to further
  115. this one, may get into contact with me via Email.
  116.  
  117. Calgor can model the behaviour of an integer array, maximum 10
  118. elements per program.  Calgor can model 10 integer variables
  119. per function.
  120.  
  121. The animation functions (see programming manual for specifics),
  122. use a limited parser to assess values.  It can evaluate absolute
  123. number (10), variable (x),  array with variable (a[x]), array
  124. with absolute offset (a[10]), or variable and integer offset
  125. (a[x+10]), however these are fixed in stone, a[b[9]] would not be
  126. evaluated properly.
  127.  
  128. Calgor does not model structure or pointer behaviour.
  129.  
  130. Errors
  131.  
  132. If at anytime Calgor produces an error it will record it
  133. "CalLog".  A more detailed error message may be produced if
  134. Calgor is run from the CLI.
  135.  
  136. Bugs.
  137.  
  138. 1).  When using a hi-res intuition pointer (WB 3.0), Calgor
  139. doesn't display it's pointer correctly.
  140.  
  141. 2).  Using a 68030, with low memory, and datacaches enabled,
  142. the menu text sometimes corrupts.  Calgor fixes this by switching
  143. off the datacaches (via the cpu command) when it starts.  The
  144. datacaches are enabled when you exit from Calgor.
  145.  
  146. To switch data caches off type (in a CLI):
  147. CPU nodatacache <RETURN>
  148. To switch data caches back on, type
  149. CPU datacache <RETURN>
  150.